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The  first  series  of  files  describe  the  computers  presently  available. 

In  front  is  a series  of  statements  that  must  be  inserted  in  two  places. 

The  first  is  in  the  block  data  routines  and  the  second  is  in  subroutine 
"URESET"  in  the  device  dependent  routines  for  each  graphics  device  supported. 
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DEVICES  SELECTED  DY  CODE  AMD  DESCRIPTION 


ALP  — Interactive  Alphanumeric  Terminals 
ARD  — ARDS  Storage  Tube  Terminals 

C56  — Calcomp  563  Drum  Plotter  — • 

C93  — Calcomp  936  Drum  Plotter 

COM  — Computek  400/15  Storage  Tube  Terminal  W/6-Bit  Interface 

DAT  — Datapoint  3300  Refresh  Alphanumeric  CRT  Terminal 

GLD  — Gould  4800  Dot-Matrix  Printer  — Bit-Matrix  Interface 

GOU  — Gould  480G  Dot-Matrix  Printer  — Calcomp  Compatible  Interface 

IML  — Imlac  PDS-1D  and  PDS-4  Terminals  — Tis  Package 

PTR  — Alphanumeric  Line  Printers 

TEK  — Tektronix  4010/4012/4013  Storage  Tube  Terminals 
TER  — Terminet  300 

TK4  — Tektronix  4014/4015  Storage  Tube  Terminals 

TSP  — Timesharing  Peripherals  TSP-212  Analog  Pen  Plotter  Terminal 
'TTY  — Remote  Batch  Alphanumeric  Terminals  • 

COMPUTERS  SELECTED  BY  CODE  AND  DESCRIPTION 

CDC  — CDC  6000  Series  Computers 
DEC  — DEC  PDP-10  Computers 
HWL  — HONEYWELL  '6000  Series  Computers 
IBM  — IBM  360/370  Series  Computers 

*t"  .V 

SUN  — Sperry  UNIVAC  1100  Series  Computers 
BUR  — Burroughs  5700/6700/7700  Series  Computers 
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DEVICE  IMPLEMENTATION  GUIDELINES 


July  5,  1978 


3-D  GCS  Version  2.0  Implementation  Guidelines  for  Devices 


I.  Introduction. 

" " ' >*<*•  A'-  V'  ’ 

The  following  paragraphs  ^develop'  guidelines  for  imple- 
menting new  devices  for  3-D  GCS.  Included  ^wlll  be  the 
definition  of  device-dependent  Graphics  Status  Area  initial- 
ization values,  functional  specifications  for  each  of  the 
3-D  GCS  device-dependent  routines,  a discussion  of  factors 
involved  in  supporting  intelligent  refresh  devices,  and  a 
description  of  a phased  sequence  for  implementing  new 
devices. T 
\ 

II.  Graphics  Status  Area  Initialization. 


t 


In  this  section,  each  of  the  device-dependent  elements 

of  the  Graphics  Status  Area  (GSA)  will  be  listed  along  with 

the  procedures  required  to  calculate  the  value,  if  appropriate. 

K3EAMX  Logical  pen  x-positlon  in  raster  units.  Default 

position  is  lower  left  corner  of  the  largest  square 
on  plotting  surface.  If  screen  is  rectangular,  the 
square  is  right-  or  bottom-justified. 

K3EAMY  Logical  pen  y-posltlon  in  raster  units.  Default 

position  is  lower  left  corner  of  the  largest  square 
on  the  plotting  surface.  If  the  screen  is  rectangular, 
the  square  is  right-  or  bottom-justified. 

KBEAMZ  Logical  pen  z-posltlon.  Default  value  is  zero. 

TRSVX  Ratio  of  screen  to  virtual  units  in  x-directlon. 

Default  is  width  of  UDAREA  in  raster  units  divided 
by  width  of  UWINDO  (100.). 

TRSVY  Ratio  of  screen  to  virtual  units  in  y-dlrectlon. 

Default  is  height  of  UDAREA  in  raster  units  divided 
by  height  of  UWINDO  (100.). 

KMINSX  Minimum  x screen  window  (UDAREA)  boundary  in  raster 
units.  Default  is  the  same  as  KBEAMX. 

KMAXSX  Maximum  x screen  window  (UDAREA)  boundary  in  raster 
units.  Default  is  maximum  address  in  x-directlon. 

KMINSY  Minimum  y screen  window  (UDAREA)  boundary  in  raster 
units.  Default  is  same  as  KBEAMY. 

KMAXSY  Maximum  y screen  window  (UDAREA)  boundary  in  raster 

units.  Default  is  the  too  boundary  of  largest  square 
in  plotting  surface. 


KMINSZ 

KMAXSZ 

KCOLGR 

TMRKSZ 

KHORSZ 

KVERSZ 

KLMRGN 

KRMRGN 

KTMRGN 

KBMRGN 

KG  IN 

KMINHX 

KMAXHX 

KMINHX 

KMAXHY 


Minimum  z screen  window  (UDAREA)  boundary  In 
raster  units.  Default  Is  same  as  KBEAMZ . 

Maximum  z screen  window  ('JDAREA)  boundary  In 
raster  units.  Default  Is  the  back:  plane  of  the 
cubical  display  volume  for  3D  devices.  For  2D 
devices,  the  xefault  Is  the  same  as  KMAX3X . 

Color  or  greyscale  switch.  Default  Is  tr.e  actual 
color  produced  by  the  plot  head  when  device  Is 
Initialized . 

Marker  horizontal  size  In  raster  units.  Default 
is  one  per  cent  of  the  maximum  physical  x address 
but  no  smaller  than  one. 

Horizontal  hardware  character  position  size  In 
raster  units.  Default  is  width  of  smallest  9lze 
character  position. 

Vertical  hardware  character  position  size  In  raster 
units.  Default  value  is  height  of  smallest  size 
character  position. 

Left  alphanumeric  margin  boundary  in  raster  units. 
Default  Is  normally  zero  (minimum  plotting  surface 
address  in  x-dlrection) . 

Right  alphanumeric  margin  boundary  In  raster  units. 
Default  is  maximum  plotting  surface  address  In 
x-direction. 


Top  alphanumeric  margin  boundary  In  raster  units. 
Default  Is  maximum  plotting  surface  address  in 
y-dlrectlon. 


Bottom  alphanumeric  margin  boundary  In  raster  units. 
Default  is  zero  (minimum  plotting  surface  address  In 
y-direction ) . 


Graphics  Input 
graphics  input 

Minimum  device 
Is  KMINSX . 

Maximum  device 
is  KMAXSX. 

Minimum  device 
Is  KMINSY. 

Maximum  device 
Is  KMAXSY . 


device  selector.  Default  Is  primary 
device  on  display. 
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KMAXDY 
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XFMZMX 

THDGPY 

KPKXMX 

KPHYMX 

XPHZMX 


Minimum  x-address  of  display  surface  In  raster  units. 
Default  Is  zero. 

Maximum  x-address  of  display  surface  In  raster  units. 
Default  for  devices  with  variable  size  plotting  surface 
is  largest  square  using  normal  plotting  medium. 

Minimum  y-addres3  of  display  surface  In  raster  units. 
Default  1 3 zero. 

Maximum  y-address  of  display  surface  In  raster  units. 
Default  for  devices  with  variable  size  plotting  surface 
Is  largest  square  using  normal  plotting  medium. 

Minimum  z-address  of  display  surface  In  raster  units. 
Default  is  zero. 


Maximum  z-address  of  display  surface  In  raster  units. 
Default  is  same  as  KMAXDX. 


X-resolutlan  in  raster  units  per  inch.  Default  Is 
KMAXDX  divided  by  width  of  plotting  surface  In  Inches. 

Y-resolutlon  In  raster  units  per  Inch.  Default  Is 
KMAXDY  divided  by  height  of  plotting  surface  in  Inches. 


Z-resolution  In  raster  units  per  inch.  Default  Is 
KMAXDZ  divided  by  depth  of  plotting  surface  in  Inches 
(or  width  if  2D  device). 

Formatted  display  surface  x-dlmenslon  In  raster  unit3. 
Default  Is  maximum  normal  x-dlmenslon. 


Formatted  display  surface 
Default  Is  maximum  normal 

Formatted  display  surface 
Default  Is  maximum  normal 
for  2D  devices). 


y-dlmenslon  In  raster  units, 
y-dlmension. 

z-dlmenslon  In  raster  units, 
z-dimenslon  (same  as  KFMXMX 


Hard  copy  delay  time  In  seconds.  Default  Is  the 
number  of  seconds  of  wait  time  required  while  a hard 
copy  is  being  generated.  Default  Is  zero  If  no  hard 
copy  capability  Is  available. 


Maximum  possible  physical  x-boundary  In  raster  units. 
Default  is  largest  possible  address.  This  could 
Include  a full  roll  of  plotter  paper. 

Maximum  possible  physical  y-boundary  In  raster  units. 
Default  Is  largest  possible  y-address. 

Maximum  possible  physical  z-boundary  in  raster  units. 
Default  is  largest  possible  z-address  (same  as  KPHXMX 
for  2D  devices). 


TRESOX 

TRESOY 

TRESOZ 

KTYMNU 

ORCLR 

KBAUDR 

KPCHAR 

KPREVC 

KPREVI 


Actual  physical  x-resolutlon  In  raster  units  per 
Inch.  Default  Is  KPHXMX  divided  by  actual  width  of 
display  surface  In  Inches. 

Actual  physical  y-resolutlon  In  raster  units  per 
inch.  Default  Is  KPHYMX  divided  by  actual  height 
of  display  surface  In  Inches. 

Actual  physical  z-resolutlon  In  raster  units  per 
inch.  Default  Is  KPHZMX  divided  by  actual  depth 
of  display  surface  in  Inches  (actual  width  Is  used 
for  2D  devices). 

Device  type  for  menu  generation.  Possible  values 
are:  Graphics  device  = 1,  Alphanumeric  device  = 2, 
Batch  device  =3. 

Number  of  modifiable  color  table  entries  supported. 
Default  Is  zero  for  devices  which  have  no  modifiable 
color  table. 

Speed  of  communication  line  In  characters  per  second. 
Default  is  usual  speed  for  device. 

X,Y  component  buffer.  Used  by  GCSPEN  as  a work  area. 
Default  should  reflect  impossible  or  unusable  value. 

Color  which  terminal  is  currently  generating.  Default 
1 3 same  as  KCOLOR. 

Current  device  Intensity  setting.  Default  is  set  to 
sixty  percent  of  maximum  screen  Intensity. 


III.  3-D  GCS  Device-Dependent  Routines. 

This  section  describes  the  functions  embodied  In  each 
of  the  3-D  GCS  device-dependent  routines.  This  discussion 
will  Include  Interface  specifications,  functional  specifi- 
cations, and  Indication  of  whether  the  function  can  be 
supported  at  the  display-device  either  In  hardware  or  soft- 
ware, relationships  to  other  functions,  and  special  Instruc- 
tions which  may  be  required  for  3-D  display-devices.  The 
functions  will  be  listed  alphabetically  within  the  two 
groups,  user-interface  and  GCS-lnternal. 


UHDCPY 


Comments : 


This  routine  causes  a hard  copy  of  the  current 
display  surface  to  be  produce!  If  an  on-line 
Immediate  hard  copy  facility  Is  available  for 
the  display  device.  A delay  can  be  programmed 
by  checking  the  GSA  variable  THDCPY  which  Indicates 
the  number  of  seconds  of  delay  required.  The 
delay  can  be  generated  by  sending  an  appropriate 
number  of  'NUL'  or  'SYN*  characters  to  the  display 
device  based  on  THDCPY  seconds  times  the  contents 
of  KBAUDR  (communication  line  speed  in  characters 
per  second). 

This  function  is  null  for  display  devices  with  no 
on-line  immediate  hard  copy  capability. 


URESBT 


Comments : 


This  routine  returns  the  Graphics  Status  Area 
to  Its  Initial  condition.  Aside  from  setting 
the  device-dependent  GSA  elements  to  agree  with 
those  In  the  Block  Data  subroutine  for  this 
device  before  compilation,  no  further  modiflcatlo 
Is  required. 

This  routine  can  not  be  supported  at  the  display- 
device. 


UWAIT (TIME) 

TIME  Indicates  the  amount  of  time  which  GCS  will 
wait  before  sending  further  commands  to  the 
display. 

Comments:  This  routine  Is  usually  Implemented  by  sending 
a sufficient  number  of  null-operation  control 
characters  across  the  communication  line  to 
cause  the  required  delay. 

The  KBAUD R GSA  element  specifies  the  line  speed 
In  characters  per  second.  For  batch  devices, 
this  routine  Is  a null-operation. 

This  routine  cannot  be  supported  at  the  display. 


GCSAL? ( ICHAR ) 


ICHAR  1 8 one  ASCII  character,  rlght-Justlf led , 
zero-fill. 

Comments:  This  routine  causes  one  hardware  character  to  be 
displayed  after  the  terminal  Is  placed  In  alpha 
mode  and  KKMODE  Is  set  to  reflect  alpha  mode.  If 
a hardware  character  generator  Is  not  available 
and  If  the  device  ls_not  Intelligent,  a devlce- 
lndpendent  hardware  character  simulator  version 
of  GCSALP  Is  available.  If  a hardware  character 
generator  or  simulator  13  available  at  the 
display,  the  printable  character  Is  simply  sent 
to  the  display.  Note  that  on  three-dimensional 
devices,  the  characters  are  always  produced  on 
the  screen  plane.  Only  printable  ASCII  characters 
are  output  from  this  routine.  The  receipt  of 
control  characters  Implies  that  the  terminal  is 
Is  to  be  placed  in  alpha  mode  and  that  the  char- 
acter size  Is  to  be  updated,  If  necessary. 

Two  control  characters  have  special  extra  meaning 
for  Intelligent  displays.  A value  of  001  q Indicates 
start  of  alpha  string  and  0028  Indicates  end  of 
alpha  string.  This  allows  strings  of  characters 
to  be  processed  as  one  primitive  operation  at  the 
display. 

To  update  the  character  size,  on  Input  the  value  of 
KSIZEP  1 8 stored  In  KPREVS  and  the  new  sizes  are 
stored  In  KHORSZ  and  KVERSZ. 

This  function  may  be  supported  at  an  intelligent 
display-device  either  by  sending  single  characters 
or  be  using  the  0010  and  0020  brackets  to  send 
entire  character  strings. 


GCSARC (X , Y .ANGLE .RADIUS , ICHECK ) 


X.Y  are  the  coordinates  of  the  center  of  the  circle 
defined  by  the  arc. 

ANGLE  Indicates  the  angle  the  arc  will  subtend  and 
the  direction  of  travel  of  the  arc.  A posi- 
tive angle  Is  counterclocicwlse , a negative 
angle  Is  cloclcwlse. 

RADIUS  specifies  the  radius  of  the  circle. 

ICHECK  Is  set  to  1 If  hardware  arc  generation  Is  not 
available  or  the  arc  was  not  drawn  for  this 
request.  It  Is  set  to  zero  If  the  requested 
arc  was  drawn. 

Comments:  If  hardware  arc  generation  Is  available  and  If 

the  arc  can  be  drawn  and  does  not  Intersect  the 
window,  the  flag  ICHECK  Is  set  to  zero  and  the 
appropriate  Instruction  Is  sent  to  the  display. 

If,  for  some  reason,  the  arc  can  not  be  drawn  at 
the  display,  the  flag  Is  set  to  1 . Reasons  which 
might  apply  are  lack  of  an  arc  generation  facility 
at  the  display  device.  Intersection  of  the  arc 
with  the  window,  or  the  viewing  and  positional 
transformations  are  such  that  the  arc  cannot  be 
drawn  in  the  current  X,Y  plane  by  the  hardware. 

This  function  may  be  supported  at  the  device  if 
the  arc  to  be  drawn  does  not  Intersect  the  window. 

If  It  does  Intersect  the  window,  GCSARC  may 
calculate  the  visible  arc  segments  and  Issue 
several  Instructions  to  draw  each  segment.  However, 
the  Instructions  to  perform  these  calculations  are 
somewhat  complex  and  It  Is  usually  left  to  UARC 
to  draw  the  desired  arc. 


I 


GCSBEG 


Comments: 


This  routine  performs  any  Initialization 
functions  required  by  the  display.  For 
Intelligent  devices.  It  may  pass  the  Initial- 
ization request  to  the  device.  For  3-D 
display-devices,  It  may  have  to  Initially 
load  the  viewing  transform  parameters  to  their 
default  values. 


GCSBPK ( IX , I Y, ICHAR ) 


IX, IY  Is  the  location  to  be  marked. 

ICHAR  is  the  fill  character  for  the  designated 

raster  position.  For  some  raster  devices, 
this  argument  may  be  used  to  indicate  the 
number  of  raster  positions  along  the  raster 
to  be  marked  starting  at  the  Indicated  raster 
position. 

Comments:  This  routine  maintains  the  internal  raster  buffer 
for  raster  devices  such  as  line  printers,  alpha- 
numeric terminals  without  cursor  addressing,  and 
direct  support  of  electrostatic  printers.  The 
buffer  is  a Fortran  Common  Area  GCSBUF  which 
contains  storage  for  the  entire  frame  or  a page 
of  the  frame.  The  IX, IY  values  are  mapped  into 
buffer  locations  and  the  character  (after  trans- 
lation into  Internal  computer  character  set)  or 
raster  positions  are  stored  there. 

This  routine  may  be  supported  at  the  display- 
device  if  an  intelligent  raster-scan  terminal 
or  an  unintelligent  raster-scan  terminal  with 
local  raster  storage.  In  this  case,  this  routine 
should  be  eliminated  with  GCSPEN  sending  the 
vector  request  directly  to  the  terminal.  This 
will  require  implementation  of  the  scan  conversion 
at  the  terminal  either  in  hardware  or  software. 


GCSCLR ( INDEX , CLR7EC ) 


INDEX  Is  the  color  table  entry  being  defined. 

CLRVEC  Is  an  array  of  seven  elements.  Each  element 

Indicates  a percentage  of  maximum  participation 
for  a particular  hue.  Basic  hues  are  In  the 
order:  RED,  GREEN,  YELLOW,  BLUE,  MAGENTA,  CYAN, 
and  WHITE. 

Comments:  This  routine  allows  redefinition  of  color  table 

entries  for  display  devices  supporting  a modifiable 
color  table.  For  all  other  devices,  this  routine 
Is  null. 

If  INDEX  exceeds  the  maximum  color  table  Index, 
the  value  of  INDEX  modulo  the  number  of  color 
table  entries  available  should  be  used. 

Since  the  values  In  CLRVEC  represent  percentages 
of  the  maximum  participation  for  a particular 
basic  hue,  they  can  also  be  thought  of  as  percent- 
ages of  maximum  Intensity.  The  actual  Intensity 
value  for  the  hue  can  be  obtained  by  multiplying 
the  maximum  Intensity  setting  by  the  CLRVEC  entry 
divided  by  100.  Note  that  If  only  a three  entry 
color  table  Is  available  (red,  blue,  green;  or 
magenta,  yellow,  cyan),  the  complementary  hues 
may  be  obtained  from  the  appropriate  components 
each  of  which  has  the  Intensity  setting  desired 
for  the  unavailable  hue.  For  example,  75#  yellow 
may  be  obtained  on  additive  color  systems  from 
75*  red  and  75^  green. 


GCSCLS 


Comments : 


This  routine  closes  the  currently  open  segment 
at  the  display  device.  Note  that  if  the  device 
draws  vectors  or  characters  by  3ome  kind  of 
vector  string  or  character  string,  this  string 
should  be  terminated  prior  to  closing;  the  segment. 
Failure  to  do  this  when  required  can  cause  mis- 
interpreted information  to  be  displayed  when  the 
segments  are  being  posted. 


GCSDEL ( NAMSEG ) 


NAMSEG  is  the  number  of  the  segment  to  be  deleted. 

Comments:  This  routine  sends  a command  to  the  display 

device  causing  the  requested  segment  to  be  deleted. 
For  display  devices  which  have  no  inherent  seg- 
mentation capability  or  requirement,  the  deletion 
is  handled  entirely  by  UDSLET  and  this  routine  is 
null.  If  NAMSEG  has  value  zero,  all  segments  are 
to  be  deleted. 

Note  htat  when  the  delete  is  requested  at  the 
display  device,  the  deletelon  should  occur  immedi- 
ately (1.  e.,  the  segment  should  be  removed  from 
the  display  surface. 


GCSDSP 


Comments: 


This  routine  transmits  the  user  display  area 
location  to  the  display-device.  This  will  only 
be  required  for  3-D  devices  which  perform  the 
viewing  transform  and  clipping  at  the  display- 
device. 


GCSEND 


Comments:  This  routine  performs  any  termination  functions 
required  by  the  display-device.  For  intelligent 
devices,  It  may  pass  the  termination  request  to 
the  device. 


I 


GCSERA 


Comments:  This  routine  provides  a clean  plotting  surface  by 

either  erasing  the  plotting  surface  or  by  advancing 
the  plotting  medium  to  an  unused  frame. 

This  function  may  be  supported  at  the  display-device. 
In  this  case,  only  an  Indication  that  the  erase  must 
occur  need  be  transmitted  to  the  device. 

Note:  in  earlier  versions  of  GCS,  thl3  function 

was  incorporated  within  a device-dependent  UERASE. 

U ERASE  has  been  made  device-independent.  It  now 
calls  GCSERA  to  actually  perform  the  erasure. 


* 


GCSFMT ( INDEX .ASPECT .WIDTH ) 

INDEX  Is  the  GCS  Index  number  for  the  supported 
format  type.  A listing  of  the  formats 
supported  may  be  found  In  UFORMT. 

ASPECT  Is  the  aspect  ratio  of  the  requested  format. 

WIDTH  Is  the  width  of  the  format  In  inches. 

Comments:  This  routine  corrects  the  display  surface  format 

boundaries  established  by  UFORMT.  Since  UFORMT 
centers  the  format  on  the  physical  display  surface 
boundaries,  no  other  action  is  required  if  that 
position  is  appropriate  for  the  requested  format. 
This  routine  will  only  be  different  from  the  null 
function  for  devices  with  variable  size  plotting 
surfaces  such  as  computer-output-mlcrof 11m  (COM) 
recorders  or  pen  plotters. 

For  COM  recorders,  the  appropriate  formats  should 
be  mapped  onto  the  address  space  in  such  a way 
that  when  the  COM  device  is  configured  with  the 
camera/lens  combination  for  the  requested  format, 
the  format  boundaries  exactly  match  the  edges  of 
the  frame  on  the  film. 

For  pen  plotters,  paper  (or  other  medium)  of  the 
appropriate  size  is  requested  to  be  made  ready  on 
the  plotter  surface. 

If  INDEX  ha3  value  zero,  GCSFMT  will  have  been 
invoked  by  UDIMBN.  In  this  case,  adjustments  as 
necessary  to  support  the  requested  aspect  ratio 
and  width  should  be  made. 


GCSFRA ( INDEX .OPCODE ) 


INDEX  la  the  numeric  Identifier  for  the  frame. 

OPCODE  la  the  action  to  b9  performed  related  to 
the  designated  frame. 

Comments:  This  routine  processes  the  frame  manipulation 
function  requests  of  "open",  "close",  "show", 
and  "unshow".  Since  these  operations  are 
currently  supported  only  In  an  Intelligent 
display,  this  function  becomes  a null  routine 
for  unintelligent  devices.  The  function  of 
this  routine  Is  primarily  to  reformat  the 
requested  operation  as  necessary  and  transmit 
It  to  the  display. 

This  Is  an  Interface  routine  which  communicates 
with  a program  executing  in  the  display-device 
general  processor  If  the  display  Is  intelligent. 


GCSIN  ( IOOUNT  , 1301' , IPRMPT  ) 


ICOUNT  Indicates  the  upper  limit  of  the  number  of  ASCII 
characters  to  be  received  as  input. 

INBUF  Is  a buffer  of  length  ICOUHT  In  which  the  ASCII 
characters  will  be  placed  right-justified , 
zero-fill. 

IPRMPT  is  an  array  containing  the  number  of  prompt 

characters  to  be  produced  in  the  first  word  and 
the  prompt  characters  in  the  succeeding  words, 
one  ASCII  character/word,  right-justified, 
zero^-flll. 

Comments:  This  is  primarily  in  Interface  routine  to  the 
operating  system  function  which  actually  sends 
the  prompt  and  obtains  the  characters.  If  less 
than  ICOUNT  characters  are  received,  the  remaining 
buffer  positions  should  be  zeroed. 

This  function  can  not  be  supported  at  the  display 
device  since  it  is  really  not  device-dependent 
but  operating  system  dependent.  However,  to 
Insure  correct  linkage  editing  on ’all  operating 
systems,  it  is  grouped  with  the  device-dependent 
routines.  Note  that  on  many  operating  systems, 
a routine  has  been  written  to  perform  this  function 
(see  3D  GCS  Host-Computer  Implementation  Guidelines). 

For  batch  devices,  this  routine  Issues  an  error 
message  and  returns  null  characters. 

If  the  operating  system  routine  does  not  handle 
prompts,  the  prompt  may  be  generated  by  the 
following  statements  prior  to  calling  the  operating 
system  input  routine: 

IFRAME=KFRAME 

KFRAME=0 

CALL  GCSOUT ( IPRMPT ( 1 ) , IPRMPT ( 2 ) , 0 ) 

KFRAME= IFRAME 


GCS INN ( ICOUNT , ISTRNG ) 


ICOUNT  Indicates  the  number  of  ASCII  characters  to 
be  read  from  the  terminal. 

ISTRNG  Is  a buffer  Into  which  ICOUNT  characters  will 
be  placed. 

Comments:  This  routine  accepts  strings  of  ASCII  characters 
from  the  terminal.  Prlop  to  Issuing  an  Input 
operation  using  GCSIN,  the  terminal  Is  placed  In 
the  appropriate  mode  to  activate  the  logical  text 
device,  usually  realized  as  a keyboard.  If 
ICOUNT  Is  less  than  or  equal  to  zero,  no  Input 
operation  takes  place. 

This  function  can  not  be  supported  at  the  display. 


GCSMAP (XIN , YIN ,ZIN ,XOUT  , YOUT  ,ZOUT  ) 


XIN,YIN,ZIN  are  the  coordinates  before  projection 

in  viewing  units. 

XOUT , YOUT  ,ZOUT  are  the  coordinates  after  projection 

is  applied  in  viewing  units. 

Comments:  This  routine  performs  orthogonal  or  perspective 
transformations  for  devices  which  do  not  perform 
viewing  transformations  at  the  display-device. 

In  this  case,  a version  of  this  routine  is 
provided.  For  devices  which  do  perform  the  view- 
ing transformation  at  the  display-device,  this 
routine  consists  3imply  of  the  input  coordinates 
mapping  into  the  output  coordinates. 


GCSMOD  (NAMSEG  .NAMAT  , NEWVAL , I LOC ) 

NAMSSG  is  the  number  of  the  segment  one  of  whose 
attributes  is  to  be  modified. 

NAMAT  is  the  number  of  the  attribute  to  be  modified: 

0 = Visibility 

1 = Highlighting 

2 = Detectlblllty 

3 = 2D  Translate  Image  Transformation 

4 = 2D  General  Image  Transformation 

5 = 3D  Translate  Image  Transformation 

6 = 3D  General  Image  Transformation 

NEWVAL  contains  the  new  setting  for  the  attribute  of 
the  specified  segment.  If  NAMAT  has  values 
0-2,  NEWVAL  will  have  values  0 = OFF  or 
1 = ON.  Otherwise,  NEWVAL  is  an  array  con- 
taining the  parameters  for  the  image  trans- 
formation requested. 

ILOC  is  the  record  number  within  the  GCS  library 
work  file  where  the  segment  is  located  if 
segmentation  is  occurring  entirely  in  the 
host-oomputer. 

Comments:  This  routine  causes  the  Indicated  segment  attri- 
bute to  be  modified  as  directed  at  the  display 
device.  Highlighting  3hould  be  supported  by 
blinking  whenever  possible. 

For  devices  which  support  segmentation  at  the 
display  device,  this  routine  sends  the  requested 
segment  attribute  modifications  to  the  display 
device.  Note  that  if  the  device  does  not  support 
image  transformations  at  a particular  level, 
requests  for  such  transforms  should  not  be  sent 
but  Ignored  or  processed  as  well  as  possible. 

For  other  devices,  segmentation  is  supported  within 
the  host  by  saving  the  segments  in  the  library  work 
file.  The  segment  attributes  are  contained  In  the 
segment  table  which  is  Inaccessible  to  the  device- 
dependent  routines.  However,  the  current  image 
transformation  is  stored  in  the  segment  header  as 
follows: 

Header  Word  5 indicates  the  number  of  words 
in  the  segment  header  exten- 
sion in  which  are  stored  the 
transformation. 

Header  Word  6 and  the  following  words,  if 

required,  contain  the  current 
image  transformation. 


GCSMOD  (cont.) 


If  the  current  appearance  of  the  segment  Is 
changed  by  the  attribute  modification,  then  the 
display  surface  must  be  updated  to  reflect  the 
change  unless  posting  modifications  is  being 
delayed  (KPOST  .EQ.  0). 


I 


GCSMRK  ( I NX , INY , INZ  , I MARK ) 


INX,INY,INZ  1 3 the  location  of  the  marker  (symbol)  In 
raster  units. 

IMARK  is  the  number  of  the  marker  to  be  generated. 

Comments:  This  routine  produces  a marker  at  the  indicated 
location  in  raster  units.  At  least  ten  markers 
are  supported  by  GCS.  Marker  0 is  always  a 
point  and  calling  GCSMRK  with  IMARK  .EQ.  0 will 
result  in  point  plotting  and  should  generate 
point  plotting  display  commands  if  they  are 
available.  If  markers  are  not  supported  at  the 
display  device,  the  markers  are  simulated  by  using 
GCSSIM.  Descriptors  of  the  markers  have  been 
defined  for  input  to  GCSSIM.  This  version  of 
GCSMRK  exists  in  current  device  libraries.  Note 
that,  even  in  this  case,  IMARK  .EQ.  0 is  produced 
by  the  special  call  to  GCSPEN  with  IPEN  .EQ.  2. 

If  markers  are  supported  at  the  display  device, 
then  commands  should  be  generated  which  will 
produce  the  requested  markers  at  the  indicated 
location. 

If  IMARK  exceeds  the  highest  marker  index,  an  IMARK 
modulo  the  number  of  markers  available  is  used. 


GCSOPN (NAMSEG .NRTSEG , ILOC ) 


NAMSSG  is  the  number  of  the  segment  to  be  opened. 

NRTSEG  are  the  Initial  segment  attribute  settings 
as  follows: 


bit 


KWR3SZ 


unused 


IS 


Visibility 

Highlighting 

Detectiblllty 


0=0  FF 
1 =QN 


ILOO  Is  the  number  of  a record  on  the  GCS  library 
work  file  In  which  the  segment  can  be  stored 
If  the  display  device  does  not  have  inherent 
segmentation  capability. 


Comments:  This  routine  opens  the  requested  segment  at  the 
display  device.  Before  a segment  Is  opened,  any 
vector  or  character  strings  which  are  currently 
being  processed  must  be  terminated  to  avoid 
problems  during  posting. 


If  segmentation  Is  maintained  at  the  display 
device,  an  "open  segment”  command  should  be  sent 
to  the  device  along  with  the  Initial  segment 
attributes. 


If  segmentation  is  being  handled  within  the  host- 
computer,  the  segment  header  must  be  Initialized. 
The  segment  header  is  located  In  the  first  words 
of  the  first  record  of  the  segment  and  has  the 
following  format: 


Index  of  first  primitive  In 
this  segment  block 


Index  of  last  word  in  this 
segment  b lock 


Count  of  bytes  In  last  word 


Jink  to  continuation  block 
0 means  none  assigned) 


Image  Transformation 
Header  Extension 
(0  size  9)  words 


Primitives 


Size  of  Image  transformation 
header  extension 


always  points  to 
beginning  of  data 


'Continuation  Flag 
0=not  continued 
1=contlnued  to 
record  In  link 


GCSOPN  (cont.) 


Note  that  for  devices  which  are  byte-oriented 
and  segmentation  Is  maintained  In  the  host-computer, 
the  device-dependent  segmentation  routines  for  the 
Tektronix  4014  probably  can  be  used  without 
modification. 


GCSOUT ( ICOUNT , IBUF , IRESP ) 


ICOUNT  indicates  the  number  of  ASCII  characters  to  be 
transmitted  to  the  display. 

IBU?  Is  the  buffer  containing  ICOUNT  ASCII  characters 
right-justified,  zero-fill. 

IRESP  Is  a count  Indicating  the  number  of  acknowledge- 
ment characters  required  from  the  terminal. 

This  Is  only  used  for  supporting  Intelligent 
devices. 

Comments:  This  Is  the  Interface  routine  between  GCS  and  the 
operating  system  routine  which  sends  characters  to 
the  terminal.  It  Is  called  by  all  GCS  routines 
which  need  to  transmit  to  the  display-device.  If 
IC0UNT=O,  the  operating  system  Is  requested  to 
flush  any  Internal  buffers. 

This  routine  cannot  be  supported  at  the  display- 
device. 

Por  batch  device,  this  routine  performs  only  one 
function:  It  Intercepts  GCS  error  messages  and 

displays  them  on  the  system  print  file. 

Por  supporting  Intelligent  displays,  the  IRESP 
argument  can  be  used  to  request  an  acknowledge- 
ment from  the  device  before  further  characters 
are  sent.  It  Is  usually  used  when  sending  functions 
which  may  require  a large  execution  time  at  the 
display. 

Por  devices  without  Inherent  segmentation  capability, 
the  Initial  action  of  this  routine  should  be  to 
save  bytes  being  directed  to  the  plot  device  If  a 
segment  Is  open.  This  Is  acccompiished  by  passing 
the  Input  to  device-dependent  routine  GCSPRM. 

When  a segment  Is  open,  the  bytes  are  only  directed 
to  the  display  surface  If  the  segment  13  being 
constructed  visibly  (1.  e.,  the  open  segment  has 
visibility  attribute  of  "on").  If  no  segment  is 
open,  the  bytes  are  always  directed  to  the  display 
surface. 


GCSPEN ( IX , IY , IZ , IPEN  ) 

IX,IY,IZ  1 3 the  end  point  of  the  line  to  be  drawn 
In  raster  units. 

IPEN  Indicates  the  operation  to  be  performed. 

Zero  specifies  a move;  one  sneclfles  a 
point;  three  specifies  a buffer  flush 
request;  and  four  specifies  a dashed  line. 

Comments:  This  routine  is  the  basic  drawing  routine  for 
each  device.  Several  variables  have  been  set 
aside  In  the  GSA  for  use  by  this  routine.  The 
array  KPCHAR  Is  for  use  as  an  Internal  work 
space  and  usually  is  where  the  command  to  be 
sent  to  the  display-device  Is  constructed. 

KPREVX , KPREVY,  and  KPREVZ  are  updated  with  the 
value  of  IX,  IY,  and  IZ  to  always  point  to  the 
current  pen  position  when  GCSPEN  terminates. 

GCSPEN  may  also  need  to  fetch  additional  infor- 
mation to  Insert  intensity,  blink,  or  other 
parameters  into  the  command.  The  variable 
KKMODE  Is  updated  to  reflect  any  mode  changes 
Initiated  by  GCSPEN. 

If  the  display-device  Is  such  that  a separate 
invisible  line  mode  Is  used,  GCSPEN  will  set 
KMOVEF  to  one  whenever  he  will  exit  with  the 
display-device  primed  for  a blank  line.  Otherwise 
KMOVEF  Is  set  to  zero  or  left  at  zero  which  is 
the  default. 

For  two-dimensional  devices,  the  IZ  and  KPREVZ 
variables  may  be  Ignored. 

For  terminal  devices,  output  from  GCSPEN  Is  sent 
through  GCSOUT.  For  batch  devices,  output  is 
written  on  the  appropriate  flies  either  directly 
or  using  a device  specific  support  package. 

Note:  GCS  assumes  that  the  plotting  surface  Is 

addressed  from  zero  to  some  maximum  positive 
number.  If  the  actual  address  range  contains 
negative  numbers,  it  is  the  responsibility  of 
GCSPEN  to  add  In  the  appropriate  displacement 
before  building  the  display  processor  commands. 


I 


GCSPQ3 ( I3EG , ILOGAT  ) 


ISEG  Is  the  number  of  the  segment  to  be  posted. 

ILOCAT  Is  the  record  number  of  the  segment  location 
If  segmentation  Is  maintained  In  the  host- 
computer. 

Comments:  This  routine  prepares  the  display  surface  for 

posting  a segment  and  also  posts  (1.  e.f  causes 
the  segment  to  be  displayed)  the  segment. 

ISEG  havelng  value  zero  Indicates  a request  that 
the  display  surface  be  prepared  for  posting,  If 
required.  For  non-refresh  display  surfaces,  this 
indicates  a clearing  of  the  display  surface  In 
preparation  for  redrawing  the  retained  segments. 

For  refreshed  display  surfaces,  this  Indicates 
that  all  non-retalned  Information  (Information  not 
in  retained  segments)  be  deleted.  In  either  case, 
when  all  segments  have  been  posted,  the  display 
surface  should  not  contain  any  Information  prepared 
outside  of  retained  segments. 

If  IS3G  has  value  other  that  zero,  the  segment 
should  be  displayed  on  the  display  surface  It  lt3 
visibility  attribute  Is  set  to  visible.  For 
displays  which  maintain  segmentation  at  the  device, 
no  action  should  be  required  since  the  display  of 
a segment  Is  controlled  by  commands  from  GCSMOD, 
GOSOPN,  or  GCSDEL.  If,  however,  the  host-computer 
maintains  the  segments,  the  segment  primitives 
must  be  copied  to  the  display  surface  (determination 
of  visibility  occurs  In  the  routine  which  calls 
GCSPOS ) . 

Note  that  for  byte-oriented  devices  with  no  Inherent 
segmentation  capability,  the  Tektronix  4014  version 
should  be  usable  unmodified. 


GCSPRM ( INCUT , INBUF ) 


INCNT  la  the  number  of  bytes  of  Information  to  be 
Inserted  In  the  segment. 

INBOP  is  the  buffer  containing  INCNT  bytes  right- 
justified,  zero-fill. 

Comments:  This  routine  Is  only  required  for  display  devices 

which  do  not  have  Inherent  segmentation  capability. 
The  function  of  this  routine  is  to  receive  bytes 
from  GCSOUT  and  to  pack  the  bytes  into  the  segment 
which  is  saved  on  records  of  the  GC3  library  work 
file.  Note  that  for  byte-oriented  devices,  the 
version  of  this  routine  in  the  Tektronix  4014 
library  should  be  usable  without  modification. 

If  the  input  to  GCSOUT  is  different  from  3-blts, 
this  will  require  that  during  execution  of  GCSPRM 
the  value  of  K3YTEL  should  be  set  to  the  appropriate 
value  and  the  value  of  ICPVf  (in  GCSPRM)  should  be 
recomputed. 


GCSPST ( OPT  ION  ) 


OPTION  Is  a standard  form  (four-character,  left- 
justified,  blank-fill)  UPSET  option  name 
passed  from  UPSET. 

Comments:  This  routine  Is  responsible  for  any  device- 
dependent parameter  setting  required  by  the 
parent  UPSET  call. 

One  option  must  always  by  processed  In  GCSPST. 

This  Is  the  "SETDASH"  function.  If  the  value 
of  KDASHT  Is  less  than  10,  thl3  Indicates  that  a 
hardware  dash  mode  Is  requested.  The  value  9 
Is  reserved  for  dotted  lines  and  1 through  8 for 
the  first  eight  hardware  dash  modes.  If  the 
display-device  does  not  support  hardware  dotted 
lines,  the  9 In  KDASHT  should  be  replaced  with 
9^4.  If  the  display-device  supports  less  than 
eight  hardware  dash  modes,  unsupported  dasn  mode 
numbers  In  KDASHT  should  be  replaced  by  56. 

Other  UPSET  options  may  be  checked  for  as  required 
by  the  dl3pley-device  and  appropriate  action 
taken. 

This  function  cannot  be  supported  at  the  display- 
device.  However,  Intelligent  devices  may  be 
passed  the  requested  setting  for  local  processing. 
Intelligent  display-devices  which  support  mode 
setting  will  require  a parallel  routine  to  receive 
the  requests  sent  by  GCSSET. 

The  setting  of  certain  hardware  attributes  should 
also  be  performed  In  this  routine.  These  are 
listed  below: 

SPACE  (devloe  or  virtual) 

PROJECTION 
WIDTH  of  lines 
BLINK  rate 
COLOR 

BRIGHTNESS  (Intensity) 

SETDASH 

MARKER  selection 
LETTER  (character  type) 

CSPACING  (character  spacing) 

ANGLE  of  text  string 
SIZE  of  characters 
XSIZE  of  characters 
fSIZE  of  characters 
PONT 

ASPECT  RATIO 


GCSPYR(XIN,YIN,ZIN,XOUT,YOUT,ZOUT) 


XIN,YIN,ZIN  are  the  coordinates  of  the  head 

endpoint  of  the  line  in  viewing 
coorlnates. 

XQUT,YOUT,ZOUT  are  the  coordinates  of  the  head  end 

of  the  visible  portion  of  the  line  in 
viewing  coordinates. 

Comments:  This  routine  provides  general  clipping  to  the 
viewing  pyramid  for  those  display-devices  in 
which  the  3-D  clipping  functions  is  not  performed 
at  the  display-device.  The  algorithm  provided 
is  that  of  Sutherland  and  Cohen  as  published  in 
Principles  of  Interactive  Graphics  by  Newman  and 
Sproull. 

For  three-dimensional  devices  which  perform  the 
3-D  clipping  function  at  the  display-device, 
this  routine  whould  set  KPYRCP  = -1  indicating 
that  no  clipping  took  place  and  then  copy  the  input 
arguments  into  the  output  arguments. 

This  routine  can  only  be  supported  in  the  display- 
device  if  the  following  conditions  hold: 

1 ) a cllpplng/dlvlder  is  provided  in  the 
hardware  or  the  Sutherland-Cohen  algo- 
rithm is  Implemented  in  the  display- 
device  mini-computer. 

2)  GCSMAP  is  also  supported  at  the  display- 
device  . 

Although  it  is  theoretically  unnecessary  for 
viewing  transformations  to  be  supported  at  the 
display-device,  most  devices  which  support  3-D 
clipping  also  support  the  viewing  transformation 
In  rotational  hardware. 


GCSRNM ( NAMQLD  , NAMNEW ) 


NAMOLD  Is  the  number  of  a currently  existing  segment. 

NAMNEVf  Is  the  new  number  by  which  the  segment  referred 
to  In  NAMOLD  will  henceforth  be  called. 

Comments:  This  routine  renames  a segment.  It  Is  a null 

routine  If  segmentation  Is  maintained  within  the 
host-computer. 

For  display  devices  which  maintain  segmentation 
at  the  device,  the  old  name  and  new  name  are  sent 
to  the  display  device  where  the  name  change  takes 
place. 


GCSVFT 


Comments: 


Thia  routine  transmits  the  viewport  dimensions 
and  position  relative  to  the  viewpoint/viewsite 
to  the  display  device.  For  all  devices  which  do 
not  support  viewing  transformations  at  the 
display,  this  operation  is  null. 


GCSVTD (XIN , YIN ,ZIN , IXOUT , IYOUT , IZOUT ) 

XIN,YIN,ZIN  contains  the  input  coordinates  In 

viewing  apace  units  after  3-D 
clipping  and  projection. 

IXOUT, IYOUT, IZOUT  contains  the  output  coordinates 

In  device  raster  units. 

Comments:  For  2-D  devices  or  3-D  devices  without  clipping 

at  the  device,  this  routine  accepts  input  virtual 
viewing  space  units  on  the  projection  plane  and 
converts  them  to  device  units  after  clipping  at 
the  UWINDO  boundaries.  For  these  devices,  a 
routine  is  provided. 

For  3-D  devices  with  clipping  at  the  device,  this 
routine  accepts  input  virtual  viewing  space  units 
and  converts  them  to  3-D  device  units  without  any 
clipping  operation. 

The  clipping  function  of  this  routine  can  be  sup- 
ported at  the  display.  This  requires  that  the 
window  definition  be  sent  to  the  display  by 
GCSDSP  and  GCSVfDO. 


GCSVUD 


Comments: 


This  routine  transmits  the  viewing  vector  speci- 
fications to  the  display-device  If  viewing  trans- 
forms are  to  be  applied  at  the  display-device. 

For  2-D  devices  and  3-D  devices  without  a local 
view  transformation,  the  location  of  the  view 
point  and  the  view  site  or  the  view  point  and 
the  direction  cosines  are  sent  In  display- 
device  units. 


GCSVUB  (XOBJ  , YOBJ  ,ZOBJ  ,XJ3YE , YBYE , ZEYB ) 


XOBJ , YOBJ ,ZOBJ  contain  the  input  coordinates  In  object 

space  units. 

XEYE, YBYB,ZEYB  will  receive  the  output  coordinates  in 
viewing  coordinate  units. 

Comments:  This  routine  converts  object  space  coordinates  to 
view  space  coordinates,  if  this  function  is  to  be 
performed  in  the  host-computer . Por  2-D  devices 
and  3-D  devices  without  local  viewing  transformatlo 
capability,  this  routine  applies  the  viewing  trans- 
formation. Por  3-D  devices  with  local  viewing 
transformation  capability,  this  routine  simply 
copies  the  input  coordinates  into  the  output  coordi 
nates.  Note  that  if  viewing  transformation  is  to 
be  applied  at  the  display-device,  the  following 
functions  must  also  be  performed  at  the  display- 
device:  3-D  clipping,  projection,  and  windowing. 


GCSWDO 


Comments : 


This  routine  transmits  the  window  boundaries  to  the 
display-device.  If  required.  For  2-D  devices  and 
3-D  devices  without  a looal  scissoring  facility, 
this  routine  Is  null.  For  3-D  devices  with  a 
local  scissor  facility,  this  routine  transmits  the 
boundary  specifications  In  view  space  units  to  the 
terminal. 


GCSWHR ( IX , I Y , IC ) 


IX,  IY  will  contain  the  raster  unit  coordinates  of  the 
input  cursor  position. 

IC  is  a mode,  status,  or  option  character  obtained 
during  the  input  operation.  If  IC  = 0 upon 
entry  to  GCSWHR,  only  the  character  is  requested 

Comments:  This  routine  performs  "positlonlng^-type  input 
operations  from  the  input  device  specified  by 
GSA  variable  KGIN  or  the  closest  available 
equivalent.  Whatever  the  form  of  the  input  coordi 
nates  when  received,  they  must  be  converted  to 
standard  raster  unit  format.  The  mode,  status,  or 
option  character  should  be  converted  to  a form 
which  can  be  identified  by  comparison  with  a 
Hollerith  string. 

This  routine  cannot  be  supported  at  the  display 
but  may  require  a parallel  function  to  execute  in 
an  Intelligent  device. 


IV.  Guidelines  for  Intelligent  Devices. 

Display-devices  which  have  computing  poser  of  their  own 
may  be  termed  Intelligent.  Appropriate  use  of  this  Intel- 
ligence can  greatly  Increase  the  capabilities  of  the  entire 
system.  Most  such  display-devices  have  a refresh  capability. 
Thus,  much  of  the  capacity  of  the  general  processor  of  the 
device  Is  Involved  with  display  list  management. 

In  GCS,  a display  list  management  facility  has  been 
provided  to  support  dynamic  pictures  In  a device-independent 
manner  to  the  extent  that  the  program  will  execute  correctly 
even  while  using  dynamic  Instructions  on  a non-refresh  device. 
This  Is  the  segmentation  facility.  A complete  name  for  this 
feature  Is  transformed,  segmented,  unstructured  display  list. 
Several  functions  are  available  In  GCS  to  create,  manipulate, 
and  delete  segments.  Segments  are  "opened"  with  a UOPEN 
(UFRAME)  function  and  are  closed  with  a UCL0S3  (UFR3ND) 
function.  Associated  with  each  segment  are  attributes  which 
may  be  modified  by  the  UMODFY  routine  and  by  the  image  trans- 
formation routines  U IMAGE , U3IMAG  , TJ? LACE , and  U3PLAC.  Seg- 
ments may  be  deleted  with  the  UDELET  function.  All  segments 
can  be  deleted  with  the  UDELA1  function.  Associated  with 
these  user-callable  routines  are  several  device-dependent 
system  routines  which  either  simulate  the  functions  or  send 
the  requests  to  the  display-device.  These  are  GCSCLS , 

GCSDEL,  GCSMOD,  GCSOPN,  GCSPOS,  GCSPRM,  and  GCSRNM. 

In  the  display,  a UOPEN  (UFRAME)  operation  starts  up  a 
new  segment  for  the  Indicated  segment  name.  If  a segment 
for  that  name  already  exists,  a double  buffering  takes  place 
which  continues  showing  the  elder  of  the  two  segments  with 
Identical  numbers  until  the  newer  segment  definition  Is 
complete  (indicated  by  receiving  a UCLOSE  (UFRBND)  command). 

At  this  time,  the  elder  segment  Is  deleted  and  the  newer 
segment  Is  displayed  (If  visible).  Since  the  double  buffering 
If  performed  entirely  by  the  device-independent  routines, 

It  need  not  be  supported  at  the  display  device.  If  a segment 
Is  constructed  visibly,  It  will  be  shown  when  completed.  It 
can  then  be  made  Invisible  by  executing  a UMODFY  (UNSHOW) 
command.  If  a segment  Is  constructed  Invisibly,  It  will  not 
be  displayed  until  a UMODFY  (USHOW)  command  Is  received 
making  It  visible.  Subsequent  UMODFY  commands  can  make  any 
segment  visible  or  Invisible  as  required. 

The  logical  organization  of  the  display  list  is  as  above. 
The  actual  physical  organization  and  technique  of  memory 
management  will  depend  on  the  particular  display-device. 

In  addition  to  display  list  management  routines,  the 
intelligent  device  general  processor  will  also  need  to 
Interface  available  hardware  functions  with  the  device- 
dependent routines  of  GCS  and  to  provide  simulators  as 
desired  for  device-dependent  functions  not  available  In  the 
particular  hardware  under  consideration. 


In  designing  the  format  In  which  the  device -dependent 
GCS  routines  communicate  with  the  display-device.  It  Is 
wise  to  select  an  encoding  scheme  that  does  not  violate 
ASCII  coding  conventions.  This  requires  that  only  seven 
bits  be  used  as  data  and  the  parity-bit  reserved  for 
parity  or  marking  even  If  the  particular  operating  system 
does  not  require  It.  Following  this  procedure  will  allow 
connection  of  the  terminal  with  the  host-computer  over 
standard  communication  lines  without  speclall  communications 
software. 

In  selecting  which  functions  should  be  simulated  in  an 
Intelligent  3-D  display-device  or  whether  a particular 
hardware  function  should  be  utilized,  the  following  table 
may  be  of  use.  For  correct  operation  of  3-D  functions, 
the  cut-off  In  the  list  of  functions  should  be  as  close  to 
the  top  as  possible  always  remembering  that  all  functions 
below  the  topmost  function  to  be  Implemented  In  the  display- 
device  must  also  be  implemented  In  the  display-device. 

Curve  Generation 
Viewing  Transformation 
3-D  Clipping 

Projection  (Perspective  or  Orthogonal) 

Windowing 

Hardware  Character  Generation 
Hardware  Dashed  Line  Processing 
Vector  Drawing 


I 


V . Implementation  Sequence 


GCS  Is  a modular  system.  Since  many  of  the  devices 
supported  by  GCS  are  relatively  unsophisticated,  many  of 
the  GCS  device-dependent  libraries  contain  simulators  for 
many  of  the  hardware  functions.  3y  using  these  simulators, 
It  Is  possible  to  shorten  the  initial  implementation  time 
for  new  devices  allowing  later  replacement  of  the  simulators 
as  time  permits  and  as  required  by  the  display-device 
capabilities. 


The  following  scheme  for  phased  implementation  of  new 
devices  has  been  designed  to  maximize  the  benefits  mentioned 
above . 


Phase  1 : Identify  the  required  initialization  values  for 

each  device-dependent  GSA  variable  and  insert  them 
in  the  Block  Data  and  UHESET  subroutines. 

Phase  2:  For  intelligent  devices,  design  the  communications 

data  structures  to  be  used  between  the  device-dependent 
GCS  routines  and  the  program  executing  in  the  display- 
device.  This  program  should  be  developed  in  parallel 
to  the  device-dependent  GCS  routines  in  the  remaining 
phases  if  not  already  available. 


Phase  3:  Implement  the  GCSBEG,  GC3PST , and  GCSEND  functions, 

if  necessary.  For  3-D  devices  with  viewing  transform 
capability,  this  may  require  initializing  the 
transform  matrix  to  the  GCS  default. 


Phase  4:  Implement  the  GCSERA , GCSPEN,  GCSVUE,  GC3VUD , GC3VPT , 
GCSVTD,  GCSDSP,  GCSWDO,  GCSPY3,  and  GCSMAP  routines. 
Note  that  for  2-D  devices  and  3-D  devices  with  no 
local  viewing  transform  capability,  the  GCSVUE, 

GCSVUD , GCSVPT , GCSPYR,  and  GCSMAP  routines  already 
exist  and  may  be  used  unmodified.  The  GCSVTD,  GCSVfDO, 
and  GCSDSP  routines  should  also  be  used  unmodified 
for  these  devices  even  if  windowing  is  available  at 
the  device  during  the  first  iteration.  The  GCSOUT 
routine  can  usually  be  used  without  modification 
from  one  of  the  other  libraries.  Simulator  or  null 
routines  can  be  used  for  the  remaining  functions. 


Phase  5:  Implement  the  GCSALF  routine  if  a hardware  character 
generator  is  available.  This  would  replace  the 
hardware  character  simulator  accessing  version  of 
GCSALF. 

Phase  6:  Implement  the  segmentation  routines,  if  the  device 
has  an  inherent  segmentation  capability.  If  not, 
the  simulator  version  of  these  routines  is 
appropriate. 


i 
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Phase  7:  Implement  the  GCSIN,  GCSINN,  and  GCSWHR  routines 
If  the  device  is  interactive.  These  would  then 
replace  the  null  routines  which  probably  were  used 
until  this  phase. 

Phase  8:  Implement  all  other  functions  which  do  not  yet 
support  the  capabilities  of  the  device. 

By  following  the  sequence  above,  experience  has  shown  that 

Implementation  of  new  devices  should  proceed  smoothly. 


J 


